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Meteor 中 文 文档 


来 源 : Meteor 中 文 文档 


Meteor 是 一 个 用 于 构建 现代 应 用 的 超 简单 的 开发 环境 。 之 前 用 最 好 的 工具 ， 都 需要 花费 数 周 
时 间 的 事情 ， 现 在 用 Meteor ， 只 需 数 小 时 。 


Web 最 初 被 设计 成 和 70 年 代 大 型 机 工作 方式 相同 。 服 务 器 泻 染 完 成 一 个 页 面 并 通过 网 络 发 送 
到 终端 。 无 论 用 户 做 了 什么 ， 服 务 端 都 会 重新 泻 染 整个 页 面 。 这 种 模式 在 Web 上 持续 了 十 多 
年 。 从 而 产生 了 LAMP ， Rails ， Django ， PHP。 


但 是 现在 ， 一 个 非常 牛 的 团队 ， 他 们 有 着 充足 的 预算 和 长 远 的 规划 ， 使 我 们 可 以 构建 运行 在 
客户 端的 javascript 应 用 。 这 些 应 用 拥有 出 色 的 界面 。 无需 刷新 网 页 ， 而 是 实时 响应 : 任何 一 
个 客户 端 产生 变化 都 会 立即 反映 到 所 有 人 的 屏幕 。 


他 们 经 过 一 番 努 力 推出 了 Meteor。Meteor 使 构建 现代 应 用 变 得 简单 而 有 趣 。 用 一 个 周末 的 时 
间或 是 在 黑客 马拉松 上 ， 你 就 可 以 构建 一 个 完整 的 应 用 。 你 无 需 再 准备 服务 器 资源 ， 或 是 部 
署 API 到 云端 ， 不 用 管理 数据 库 或 是 纠缠 于 ORM 层 ， 不 用 再 在 javascript 和 Ruby 之 间 来 回 切 
换 ， 也 不 用 再 广播 无 效 数 据 给 客户 端 。 


快速 开始 ! 


Meteor 支持 OS X, Windows, and Linux. 
用 Windows? 下 载 官 方 安装 包 . 


用 OS X 或 是 Linux? 通过 命令 行 安 装 Meteor 官 方 最 新 版 : 


$ curl https://install.meteor.com/ | sh 


Windows X &, € 4& Windows 7, Windows 8.1, Windows Server 2008, 和 Windows Server 
2012» 44 1T3 > € 4 Mac OS X 107 (Lion) 及 其 以 上 版 本 , Linux x86 和 x86 64 架构 . 


安装 完成 之 后 ， 创 建 一 个 项 目 : 
$ meteor create myapp 


在 本 地 运行 : 


$ cd myapp 
$ meteor 
4 Meteor server running on: http://localhost:3000/ 


后 ， 打 开 一 个 命令 行 窗 口 ， 发 布 到 线 上 《我 们 提供 的 一 个 免费 服务 器 ) 


$ meteor deploy myapp.meteor.com 


Meteor 的 理念 


Data on the Wire. Meteor 不 在 网 络 上 发 送 HTML。 服 务 器 发 送 数据 ， 让 客户 端 来 泻 染 它 。 
One Language. Meteor 使 你 可 以 用 javascript 来 实现 应 用 的 客户 端 和 服务 端 
Database Everywhere. 在 客户 端 和 服务 端 ， 你 可 以 使 用 相同 的 方法 来 使 用 数据 库 。 


Latency Compensation. 在 客户 端 ，Meteor 预 加 载 数据 以 及 本 地 模拟 的 模式 使 它 看 起 来 
就 像 是 服务 端 方法 调用 立即 返回 了 一 样 。 


Full Stack Reactivity. 在 Meteor 中 ， 默 认 是 实时 性 的 。 所 有 层面 ， 从 数据 库 到 模板 ， 都 会 
在 需要 的 时 候 自 动 更 新 。 


Embrace the Ecosystem. Meteor 是 开源 的 ， 并 且 集 成 了 现 有 的 开源 工具 和 框架 


Simplicity Equals Productivity. 让 事情 看 起 来 简单 最 好 的 方式 就 是 让 它 站 的 成 为 简单 地 
事 。Meteor 的 主要 功能 点 的 API 非 常 干净 、 经 典 漂亮 。 


有 很 多 社区 资源 可 以 帮助 你 开发 应 用 。 如 果 你 对 Meteor 感 兴趣 ， 斋 望 你 能 参与 其 中 ! 
教程 

快速 开始 Meteor 官方 教程 ! 

Stack Overflow 


对 于 技术 问题 ， 提 问 、 寻 找 答案 最 好 的 去 处 就 是 Stack Overflow. 确保 给 你 的 问题 添加 


meteor 标签 。 

论坛 

访问 Meteor discussion forums 宣 布 项 目 ， 寻 求 帮助 ， 讨 论 社区 或 是 讨论 核心 模块 的 变动 。 
GitHub 


核心 代码 在 GitHub 上 . 如 果 你 会 写 代码 或 是 提 issue， 我 们 很 想得到 你 的 帮助 。 对 于 如 何 开 
16 » db A i: Contributing to Meteor 


meteor help 


获取 meteor 命令 行使 用 帮助 。 和 运行 meteor help 会 列 出 meteor 所 有 命令 。 运 
行 meteor help &lt;command&gt; 会 打 印 出 关于 meteor &lt;command&gt; 的 详细 帮助 9 


meteor create &lt;name&gt; 


创建 一 个 名 为 &lt;name&gt; 的 子 目 录 ， 并 在 里 面 新 建 一 个 Meteor 应 用 。 


meteor run 


使 用 Meteor 本 地 开发 服务 器 运行 当前 应 用 ， 地 址 为 : http://localhost:3000 


meteor debug 


附带 着 Node Inspector 运行 这 样 你 就 可 以 一 步 一 步 跟踪 服务 端 代码 。 更 多 信息 查 
看 meteor debug 


meteor deploy &lt;site&gt; 


打包 你 的 应 用 ， 并 发 布 到 &lt;site&gt; ? 如 果 你 发 布 到 &lt;your app&gt;.meteor.com ， 
Meteor 提 供 免费 的 主机 ， 只 要 &lt;your app&gt; 的 名 字 还 未 被 其 他 人 使 用 。 


meteor update 


升级 Meteor 到 最 新 发 布 版 ， 然 后 (如 果 meteor update 是 在 一 个 应 用 目录 中 执行 的 ) 升级 当前 
项 目 使 用 的 包 到 最 新 兼容 版 。 


meteor add 

添加 一 个 包 (或 多 个 ) 到 Meteor 项 目 中 。 要 查询 可 用 的 包 ， 使 用 meteor search 命令 。 
meteor remove 

移 除 之 前 添加 到 项 目 中 的 包 。 查 看 项 目 使 用 的 包 列 表 ， 用 meteor list TA ° 


meteor mongo 


打开 一 个 MongoDB shell 来 查看 、 操 作 数 据 库 中 的 集合 。 注 意 : 你 必须 先 运行 当前 应 用 (在 另 
外 的 命令 行 )， meteor mongo 才能 连接 到 应 用 的 数据 库 


meteor reset 


重 置 当 前 项 目 为 初始 状态 。 移 除 所 有 本 地 数据 。 


如 果 你 经 常 使 用 meteor reset ^" 但 是 又 不 想 丢失 一 些 初始 数据 ? 考虑 使 用 Meteor.startup 
在 服务 第 一 次 启动 时 重建 这 些 数据 。 


if (Meteor.isServer) { 
Meteor.startup(function () { 


if (Rooms.find().count() === 0) ( 
Rooms.insert((name: "Initial room")); 
} 
3; 


} 


文件 结构 


对 于 该 如 何 组 织 应 用 的 文件 结构 ，Meteor 是 非常 灵活 的 。 它 会 自动 加 载 所 有 文件 ， 所 以 不 需 
要 再 用 &lt;script&gt; 或 &lt;link&gt; 标签 来 引入 javascript 和 CSS ° 


文件 的 默认 加 载 
如 果 某 个 文件 在 下 面 提 到 的 特殊 文件 夹 之 外 ，Meteor 会 做 如 下 处 理 : 


1. HTML 模 板 编译 完成 后 发 送 到 客户 端 。 详 细 信 息 参 见 the templates section ° 
2，CSS 文 件 发 送 到 客户 端 。 在 生产 模式 下 ， 会 自动 合并 、 压 缩 。 
3. Javascript 被 加 载 到 客户 端 和 服务 端 。 可 以 使 用 Meteor.isclient 和 Meteor.isServer 来 
控制 特定 代码 的 运行 位 置 。 
如 果 你 想 更 好 的 控制 哪些 javascript 代 码 加 载 到 客户 端 或 是 服务 端 ， 可 以 使 用 下 面 列 出 的 特殊 
文件 夹 。 


特殊 文件 夹 


/client 

/client 文件 夹 中 所 有 文件 都 只 发 送 到 客户 端 。 用 来 放置 HTML，CSS 和 Ul 相 关 的 javascript 
代码 。 

/server 

/server 文件 来 中 所 有 文件 都 只 提供 给 服务 端 使 用 ， 不 会 发 送 到 客户 端 。 用 来 放置 不 应 该 被 
客户 端 看 到 的 敏感 逻辑 和 数据 。 

/public 


/public 文件 夹 中 的 文件 会 原样 发 送 到 客户 端 。 用 来 放置 资源 ， 例 如 : 图 片 。 假 设 有 张 图 
H /public/background.png ， 在 HTML 中 用 &lt;img src-'/background.png'/&gt; 引用 或 是 在 
CSS 中 用 background-image: url(/background.png) 引用 。 注意 图 片 URL 中 不 包含 /public ? 


/private 


e 


/private 文件 夹 中 的 文件 只 能 由 服务 端 代码 通过 assets API 来 获取 ， 客 户 端 无 法 获取 。 


E 


更 多 关于 文件 加 载 顺序 和 特殊 文件 夹 的 说 明 参 见 Structuring Your App section 


开发 手机 应 用 
当 你 用 Meteor 开 发 完成 web app 之 后 ， 只 需 几 个 命令 ， 就 可 以 轻松 地 构建 一 个 native 包 装 ， 并 


发 布 到 Google Play Store 或 是 iOS App Store。 我 们 用 了 很 大 精力 ， 使 相同 的 包 和 API 在 桌面 
端 和 移动 端 都 能 工作 ， 所 以 你 无 须 担 心 大 量 的 移动 应 用 开发 相关 的 边界 情况 。 


安装 手机 SDKs 


安装 Android 或 ios 开发 工具 : 


meteor install-sdk android & for Android 
meteor install-sdk ios # for iOS 
添加 平台 


添加 相关 平台 到 你 的 应 用 : 


meteor add-platform android 4 for Android 
meteor add-platform ios # for iOS 

> 二 sa pE +】 9E 

运行 模拟 器 
meteor run android # for Android 
meteor run ios # for iOS 


在 设备 上 运行 


meteor run android-device # for Android 
meteor run ios-device # for iOS 


Bo a APP E 1s fe» metadata 


可 以 用 特殊 的 文件 mobile-config.js 配置 APP 的 图 标 、 标 题 、 版 本 号 、 启 动画 面 以 及 其 他 
metadata ° 


更 多 关于 Meteor 对 移动 端的 支持 参见 GitHub wiki page ° 


The Meteor API 


Javascript 代 码 可 以 运行 在 两 种 环境 : 客户 端 (浏览 器 )， 和 服务 端 (服务 器 上 的 Node.js 容 器 ) 。 
在 API 参考 中 ， 我 们 会 指出 每 个 函数 是 否 可 以 在 客户 端 ， 或 是 服务 端 ， 或 是 Anywhere( 客 户 端 


和 服务 端 ) 被 调用 。 


模板 


在 Meteor 中 ， 视 图 定义 在 模板 。 模 板 就 是 包含 动态 数据 的 HTML 代 码 段 。 你 可 以 通过 
javascript 给 模板 插入 数据 ， 或 是 监听 模板 事件 。 


用 HTML 定 义 模 板 


模板 定义 在 ,html 文件 中 ， 可 以 放 在 项 目 任何 位 置 ， 除 了 server , public , private 文件 夹 


每 个 .html 文件 可 以 包含 任意 数量 的 顶级 元 素 * &lt;head&gt; , &lt;body&gt; 或 
是 &lt;template&gt; ° &lt;head&gt; , &lt;body&gt; 标签 里 的 代码 会 附加 到 HTML 页 面 中 对 应 
的 标签 ， &ltitempalte&gt; 标签 里 的 代码 可 以 用 {{&gt; templateName}} 引入 ， 如 下 面 的 例子 
所 示 。 模 板 可 以 引入 多 次 一 模板 的 主要 目的 之 一 就 是 避免 重复 手写 相同 的 HTML 。 
<!-- add code to the <head> of the page --> 
<head> 
<title>My website!</title> 
</head> 
<!-- add code to the <body> of the page --> 
<body> 
<h1>Hello!</h1> 
{{> welcomePage}} 
</body> 
<!-- define a template called welcomePage --> 
<template name="welcomePage"> 


«p»Welcome to my website!</p> 
</template> 


GL... 33 是 Spacebars 语 法 ，Meteor 使 用 Spacebars 给 HTML 增 加 功能 。 如 上 所 示 ， 利 用 它 
你 可 以 引入 模板 。 使 用 Spacebars， 你 可 以 显示 从 helpers 中 获取 的 数据 。Helpers 用 
javascript 来 写 ， 既 可 以 是 简单 值 ， 也 可 以 是 函数 。 
Template.myTemplate.helpers(helpers) 

Client 


Specify template helpers available to this template. 


Arguments 
helpers Object 
Dictionary of helper functions by name. 


给 nametag 模板 定义 一 个 叫做 name f helper(4 javascript €.) : 


Template .nametag.helpers({ 
name: "Ben Bitdiddle" }); 


nametag 模板 本 身 (在 HTML 里 ): 


<!-- In an HTML file, display the value of the helper --> 
«template name-"nametag"» 

<p>My name is {{name}}.</p> 
«/template» 


Spacebars 还 有 几 个 方便 使 用 的 控制 结构 ， 可 以 使 视图 更 加 动态 : 


e {{#each data)) ... {{/each}} - 循环 data 里 的 每 一 项 ， 每 一 项 都 会 显示 一 次 #each Ik 
里 的 HTML ° 
e {{#if data) ... ((else)) ... ((/if)]) -如 果 data 为 true ， 显 示 第 一 个 块 ， 反 之 ， 显 
示 第 二 个 块 。 
e {{#with data}} ... {{/with}} -设置 内 部 HTML 的 数据 上 下 文 ， 然 后 显示 。 
每 一 个 秦 套 的 #each 或 #with 块 都 有 自 己 的 数据 上 下 文 ,数据 上 下 文 是 一 个 对 象 ， 它 的 属性 


在 块 内 部 可 以 用 作 helper。 例 如 : #with 块 ， 它 的 数据 上 下 文 就 是 跟 在 它 后 面 ，}} 之 前 的 变 
量 值 。 #each 块 ， 循 环 到 的 元 素 会 作为 当前 数据 上 下 文 。 


例如 ， people helper 的 值 为 : 


Template.welcomePage.helpers({ 
people: [{name: "Bob"}, (name: "Frank"}, {name: "Alice"}] 


3); 


然后 你 可 以 用 一 个 &lt;p&gt; 标签 列表 显示 每 一 个 人 的 姓名 : 


{{#each people}} 
<p>{{name}}</p> 
{{/each}} 


或 是 用 上 面 的 "nametag" 模 板 代替 &lt;p&gt; 标签 : 


{{#each people)? 
{{> nametag}} 
{{/each}} 


记 住 : helper T RÈ HKI’ 也 可 以 是 函数 。 例 如 ， 要 显示 登录 用 户 的 用 户 名 ， 你 可 以 定义 一 
个 叫做 username 的 helper : 


// in your JS file 
Template.profilePage.helpers(([ 
username: function () 1 
return Meteor.user() && Meteor.user().username; 


J 
3); 


现在 ， 每 次 使 用 username helper 的 时 候 ， 都 会 调用 上 面 的 helper 函 数 来 确定 用 户 名 : 


<!-- in your HTML --> 

«template name-"profilePage"- 
«p»Profile page for {{username}}</p> 

«/template» 


Helper 可 以 接收 参数 。 例 如 ， 


Template.post.helpers({ 
commentCount: function (numComments) { 
if (numComments === 1) { 
return "1 comment"; 
) else { 
return numComments + " comments"; 


3; 
参数 放 在 大 括号 里 ，helper 名 之 后 : 
<p>There are {{commentCount 3}}.</p> 


上 面 定义 的 helper 都 关联 到 特定 的 模板 ， 可 以 用 Template.registerHelper 定义 所 有 模板 都 能 
用 的 helper ° 


关于 Spacebars 更 详细 的 文档 参见 README on GitHub。 后 面 的 session , 
Tracker , Collections , fe Accounts 小 节 会 有 如 何 给 模板 添加 动态 数据 的 讨论 9 


Template.myTemplate.events(eventMap) 


Client 


Specify event handlers for this template. 


Arguments 
eventMap Event Map 


Event handlers to associate with this template. 


传 给 Template.myTemplate.events 的 事件 map, 用 事件 描述 符 作 为 key, 事 件 处 理 函 数 作为 
value。 事 件 处 理 函 数 接收 两 个 参数 : 事件 对 象 和 模板 实例 。 事 件 处 理 函 数 中 通过 this 获取 
数据 上 下 文 。 


假设 有 下 面 的 模板 : 


<template name="example"> 
{{#with myHelper}} 
<button class="my-button">My button</button> 
<form> 
<input type="text" name="myInput" /> 
<input type="submit" value="Submit Form" /> 
</form> 


{{/with}} 


</template> 


调用 Template.example.events 给 模板 增加 事件 处 理 器 : 


Template.example.events(í 
"click .my-button": function (event, template) { 
alert("My button was clicked!"); 
"submit form": function (event, template) { 
var inputValue - event.target.myInput.value; 


var helperValue - this; 
alert(inputValue, helperValue); 


} 
3); 


key 的 前 半 部 分 是 要 捕获 的 事件 名 称 。 几 乎 支持 所 有 的 DOM 事 件 ， 常 见 的 有 : click, 
mousedown , mouseup , mouseenter , mouseleave , keydown , keyup , keypress , focus 


blur ， 和 change ° 

key 的 后 半 部 分 是 CSS 选 择 器 ， 用 来 指明 要 监听 的 元 素 。 几 乎 支持 所 有 JQuery 支 持 的 选择 器 . 
无 论 何 时 ， 选 定 元 素 上 触发 了 监听 的 事件 时 ， 对 应 的 事件 处 理 函 数 就 会 被 调用 ， 参 数 为 : 
DOM 事件 对 象 和 模板 实例 。 详 细 信 息 参 见 Event Maps section 


Template.myTemplate.onRendered 
Client 


Register a function to be called when an instance of this template is inserted into the DOM. 


Arguments 
callback Function 


A function to be added as a callback. 


用 这 个 方法 注册 的 函数 会 在 Template.myTemplate 模 板 的 每 个 实例 第 一 次 插入 到 页 面 的 时 候 调 
用 一 次 。 

这 个 回调 函数 可 以 用 来 集成 那些 不 适应 Meteor 自 动 视图 浑 染 机 制 ,并 且 需 要 在 每 次 HTML 插 入 
到 页 面 时 进行 初始 化 的 第 三 方 库 。 你 可 以 在 oncreated 和 onDestroyed 回调 中 执行 对 象 初 始 
化 或 是 清理 工作 。 


例如 ， 要 使 用 HighlightJS 库 高 亮 codesample 模板 中 所 有 &lt;pre&gt; 元 素 ， 你 可 以 传递 如 下 


回调 函数 给 Template.codeSample.onRendered 


Template.codeSample.onRendered(function () { 
hljs.highlightBlock(this.findAll('pre')); 


}); 


在 回调 函数 中 ， this 指向 一 个 template instance 对 象 实例 ，that is unique to this inclusion of 
the template and remains across re-renderings. 可 以 使 用 方法 this.find 和 this.findAll 来 
获取 模板 泻 染 后 的 HTML DOM 节 点 。 


Template instances 

一 个 模板 实例 对 象 代表 文档 对 模板 的 一 次 引入 。 模 板 实例 可 以 用 来 获取 模板 中 的 HTML 元 素 ， 
还 可 以 给 模板 实例 附加 属性 ， 属 性 会 在 模板 响应 式 更 新 中 保持 ， 不 会 丢失 。 

在 好 几 个 地 方 都 可 以 获取 到 模板 实例 对 象 : 


1. 在 created , rendered 和 destroyed 模板 回调 中 ，this 指 向 模板 实例 
2， 事 件 处 理 器 的 第 二 个 参数 
3. 在 Helper 中 ， 通 过 remplate.instance() 获取 模板 实例 


你 可 以 选择 给 模板 实例 附加 属性 ， 来 跟踪 模板 相关 的 状态 。 例 如 ， 当 使 用 Google Maps API 
时 ， 你 可 以 附加 map 对 象 到 当前 模板 实例 ， 这 样 就 可 以 在 Helper 和 事件 处 理 器 中 引用 map 对 
象 。 用 oncreated 和 onpestroyed 回调 函数 来 执行 初始 化 或 清理 工作 。 


template.findAll(selector) 


Client 


Find all elements matching selector in this template instance. 


Arguments 
selector String 
The CSS selector to match, scoped to the template contents. 


template.findAll 返回 一 个 符合 selector 的 DOM 元 素数 组 。 也 可 以 使 用 template.$ ， 它 的 
工作 方式 和 JQuery 的 s 函数 一 样 ， 但 是 只 返回 template 内 部 的 元 素 。 


template.find(selector) 


Client 


Find one element matching selector in this template instance. 


Arguments 
selector String 
The CSS selector to match, scoped to the template contents. 


find 类 似 findali 但 是 只 返回 找到 的 第 一 个 元 素 。 和 findAll 一 样 ， find 只 返回 模板 内 部 
的 元 素 。 


Session 
在 客户 端 ， session 提供 了 一 个 全 局 对 象 ， 可 以 用 它 来 保存 任意 的 键 值 对 。 例 如 : 保存 列表 
中 当前 选中 项 。 


Session 的 特殊 之 处 在 于 ， 它 是 响应 式 的 。 如 果 在 template helper 或 rracker.autorun 里 调用 
了 session.get("myKey") ， 那 么 无 论 何 时 调用 session.set("myKey"，newValue) 都 会 触发 相应 
的 模板 片段 自动 重新 泻 染 。 


Session.set(key, value) 


Client 

将 session 里 键 key 的 值 设 为 value。 并 通知 所 有 监听 器 : 键 key 的 值 发 生 了 变化 〈 例 如 : 通知 那 
些 调用 session.get 获取 键 key 值 的 模板 helper 或 是 autorun， 重 新 泻 染 模板 或 是 重新 执 

ÍT Tracker.autorun ) ° 

Arguments 

key String 

The key to set, eg, selectedItem 


value EJSON-able Object or undefined 


The new value for key 


Session.get(key) 


Client 

获取 session 里 键 key 的 值 。 如 果 是 在 一 个 响应 式 计算 (reactive computation) HÈR » 3$ 38 

过 session.set 修改 键 key 的 值 时 ， 会 作废 对 应 的 计算 。 这 个 方法 会 返回 键 key 值 的 克隆 副 
本 ， 所 以 如 果 键 key 的 值 是 一 个 对 象 或 数组 ， 修 改 返回 值 并 不 会 改变 Session 里 键 key 的 值 。 
Arguments 

key String 

The name of the session variable to return 


例如 : 


<!-- In your template --> 
«template name-"main"» 

«p»We've always been at war with [[theEnemy]].«/p» 
«/template» 


// In your JavaScript 
Template.main.helpers((í 
theEnemy: function () { 
return Session.get("enemy"); 


} 
3); 


Session.set("enemy", "Eastasia"); 
// Page will say "We've always been at war with Eastasia" 


Session.set("enemy", "Eurasia"); 
// Page will change to say "We've always been at war with Eurasia" 


Seesion 带 我 们 初次 体会 到 了 响应 式 的 魅力 ， 视 图 会 在 必要 时 自动 更 新 ， 无 需 手 动 调 
用 render 函数 。 在 下 一 节 2 将 会 学 习 如 何 使 用 Tracker P 一 个 非常 轻 量 的 库 d 使 响应 式 成 为 


可 能 。 


Tracker 
Meteor 包含 一 个 简单 地 依赖 跟踪 系统 ， 使 用 它 可 以 在 session 变量 、 数 据 库 查询 或 其 它 数据 
源 发 生变 化 时 自动 重新 泻 染 模板 或 是 重新 运行 某 些 函数 。 


和 其 它 的 依赖 跟踪 系统 不 同 ， 不 需要 手工 声明 依赖 一 它 就 能 工作 。 它 的 机 制 简单 而 高 效 。 一 
旦 你 用 Tracker.autorun 初始 化 了 一 个 计算 (computation)，Tracker 自动 记录 使 用 到 的 数据 。 
当 这 些 数据 发 生变 化 时 ， 计 算 就 会 自动 重新 运行 。 这 就 是 为 什么 当 helper functions 返 回 新 数 
据 时 模板 知道 如 何 重新 泻 染 。 


Tracker.autorun(runFunc, [options]) 


Client 


Run a function now and rerun it later whenever its dependencies change. Returns a 
Computation object that can be used to stop or observe the rerunning. 


Arguments 
runFunc Function 


The function to run. It receives one argument: the Computation object that will be returned. 


Options 
onError Function 


Optional. The function to run when an error happens in the Computation. The only argument 
it recieves is the Error thrown. Defaults to the error being logged to the console. 


Tracker.autorun 使 你 可 以 声明 一 个 依赖 响应 式 数据 源 的 函数 ， 无 论 何 时 数据 源 发 生变 化 ， 函 
数 都 会 被 重新 执行 。 


例如 ， 可 以 监测 一 个 session 变量 ， 设 置 另 外 一 个 : 


Tracker.autorun(function () { 
var celsius - Session.get("celsius"); 
Session.set("fahrenheit", celsius * 9/5 + 32); 


3); 


或 者 可 以 等 待 session 变 量 成 为 一 个 特定 值 ， 执 行 一 些 特 定 操作 。 如 果 想 阻止 回调 函数 进一步 
重新 运行 ， 可 以 调用 计算 (computation) 对 象 的 stop ， 计 算 对 象 会 作为 回调 函数 的 第 一 个 参数 
HX: 


// Initialize a session variable called "counter" to 0 
Session.set("counter", 0); 


// The autorun function runs but does not alert (counter: 0) 
Tracker.autorun(function (computation) 1 
if (Session.get("counter") === 2 
computation.stop(); 
alert("counter reached two"); 


J 
3); 


// The autorun function runs but does not alert (counter: 1) 
Session.set("counter", Session.get("counter") + 1); 


// The autorun function runs and alerts "counter reached two" 
Session.set("counter", Session.get("counter") + 1); 


// The autorun function no longer runs (counter: 3) 
Session.set("counter", Session.get("counter") + 1); 


Tracker.autorun 第 一 次 被 调用 的 时 候 ， 回 调 函 数 立 即 被 执行 ， 如 果 此 时 counter === 2 > 3B 
么 就 会 alert， 然 后 立即 停止 。 在 上 面 的 例子 中 ， 当 Tracker.autorun 被 调用 

时 ， session.get("counter") === 0 ， 所 以 第 一 次 什么 都 不 会 发 生 ， 每 次 counter 发 生变 化 
时 ， 回 调 函 数 都 会 重新 运行 ， 直 到 当 counter 等 于 2 的 时 候 ， computation.stop() 被 调用 。 


如 果 autorun 在 第 一 次 执行 时 抛 出 了 异常 ， 那 么 计算 (computation) 会 自动 停止 ， 以 后 也 不 会 重 
新 运行 。 


关于 Tracker. 的 工作 原理 和 高 级 用 法 ， 参 见 Meteor 手册 里 的 Tracker 一 节 ， 里 面 有 更 加 详细 的 
说 明 。 


Collections 


Meteor 用 集合 保存 数据 。 集 合 里 保存 的 Javascript 对 象 叫做 文档 。 使 


用 new Mongo.Collection 声明 一 个 集合 。 


new Mongo.Collection(name, [options]) 


Anywhere 


Constructor for a Collection 


Arguments 
name String 
The name of the collection. If null, creates an unmanaged (unsynchronized) local collection. 


调用 Mongo.Collection 44 3& AAA £g — 4- d Go o 094179 MongoDB 的 集合 。 如 果 在 
创建 集合 时 传 入 了 一 个 hame 参 数 ， 那 么 声明 的 就 是 一 个 持久 性 集合 一 保存 在 服务 端 并 可 以 
发 布 到 客户 端 。 


要 想 使 客户 端 代码 和 服务 端 代码 都 可 以 通过 相同 的 API 访 问 相 同 的 集合 ， 最 好 在 一 个 客户 端 和 
服务 端 都 能 加 载 到 的 javascript 文 件 中 把 集合 声明 为 全 局 变量 。 


示例 : 声明 两 个 命名 的 ， 持 久 性 的 集合 作为 全 局 变量 : 


// In a JS file that's loaded on the client and the server 
Posts - new Mongo.Collection("posts"); 
Comments - new Mongo.Collection("comments"); 


如 果 传 入 null 作为 name 参 数 ， 那 么 创建 出 来 的 就 是 一 个 本 地 集合 。 本 地 集合 不 会 在 客户 端 
和 服务 端 之 间 进 行 同 步 ; 它 只 是 javascript 对 象 的 临时 集合 ， 支 持 Mongo-style find, 


insert ， update , 和 remove 操作 o 


默认 情况 下 ，Meteor 会 自动 发 布 所 有 集合 里 的 文档 到 每 一 个 连接 上 的 客户 端 。 要 禁用 此 行 
为 ， 必 须 移 除 autopublish 包 : 


$ meteor remove autopublish 


然后 ， 使 用 Meteor.publish 和 Meteor.subscribe 来 指定 集合 的 哪 一 部 分 发 送 到 哪些 客户 端 。 


使 用 findone 和 find 从 集合 里 检索 文档 。 


collection.findOne([selector], [options]) 


Anywhere 


Finds the first document that matches the selector, as ordered by sort and skip options. 


Arguments 
selector Mongo Selector, Object ID, or String 


A query describing the documents to find 


Options 
sort Mongo Sort Specifier 
Sort order (default: natural order) 
skip Number 
Number of results to skip at the beginning 
fields Mongo Field Specifier 
Dictionary of fields to return or exclude. 
findone 方法 可 以 从 集合 里 查找 特定 的 文档 。 调 用 findone 时 ， 通 常 都 会 传 入 一 个 特定 文档 


的 id: 


var post = Posts.findOne(postId); 


然而 ， 也 可 以 给 findone 传 入 一 个 Mongo 选择 器 ，Mongo 选 择 器 是 一 个 对 象 ， 指 明了 目标 文 
又 


择 
档 要 满足 的 一 系列 属性 。 例如， 下 面 的 选择 器 


var post = Posts.findOne(( 
createdBy: "12345", 
title: {$regex: /first/} 
}); 


会 匹配 到 下 面 的 文档 


{ 
createdBy: "12345", 
title: "My first post!", 
content: "Today was a good day." } 


X f MongoDB query operators 例如 $regex , $1t (DF), $text (文本 搜索 ) 的 更 多 信息 参 
X MongoDB documentation ° 


一 个 非常 有 用 但 是 不 那么 明显 的 功能 就 是 Mongo 选择 器 可 以 匹配 数组 里 的 元 素 。 例 如 : 下 面 
的 选择 器 


a 


Post.findone({ 
tags: "meteor" }); 


会 匹配 到 下 面 的 文档 


title: "I love Meteor", 
createdBy: "242135223", 
tags: ["meteor", "javascript", "fun"] } 


findone 方法 和 session.get 一 样 ， 也 是 响应 式 的 ， 也 就 是 说 ， 如 果 你 在 template helper X 
Tracker.autorun WH EZ P 4$] findone ， 如 果 findone 返回 的 文档 发 生 了 变化 ， 那 么 模 
板 就 会 自动 重新 泻 染 ， 计 算 会 重新 执行 。 

注意 ， 如 果 findone 没有 找到 任何 文档 ， 则 返回 null ， 通 常 发 生 在 文档 还 没 加 载 或 是 已 经 从 
集合 中 移 除 ， 所 以 要 有 处 理 null 值 的 准备 。 


collection.find([selector], [options]) 


Anywhere 


Find the documents in a collection that match the selector. 


Arguments 

selector Mongo Selector, Object ID, or String 
A query describing the documents to find 
Options 

sort Mongo Sort Specifier 

Sort order (default: natural order) 

skip Number 

Number of results to skip at the beginning 
limit Number 

Maximum number of results to return 
fields Mongo Field Specifier 


Dictionary of fields to return or exclude. 


find 方法 和 findone 类 似 ， 不 同 的 是 ， 
游标 是 一 个 特殊 的 对 象 ， 代 表 一 个 查询 里 
标 ， 或 是 其 它 可 以 返回 数组 的 地 方 : 


Template.blog.helpers({ 
posts: function () { 


Id 


它 不 返回 单一 文档 ， 而 是 返回 一 个 MongoDB 游标 。 
会 被 返回 的 文档 列表 。 可 以 在 模板 Helper 里 返回 游 


A 


// this helper returns a cursor of 
// all of the posts in the collection 


return Posts.find(); 
} 
}); 


<!-- a template that renders multiple 
«template name-"blog"» 
{{#each posts)? 
<h1>{{title}}</h1> 
<p>{{content}}</p> 
{{/each}} 
</template> 


要 想 从 一 个 游标 里 检索 当前 的 文档 列表 时 


// get an array of posts 
var postsArray = Posts.find().fetch(); 


记 住 ， 虽 然 调用 fetch 的 计算 会 在 数据 变化 时 重新 运行 


reactive if it is passed somewhere else. 


posts --> 


> 调用 游标 的 .fetch() 方法 : 


， 但 是 the resulting array will not be 


通过 调用 insert , update ,或 remove 来 修改 保存 在 Mongo, Collection 里 的 数据 。 


collection.insert(doc, [callback]) 


Anywhere 


Insert a document in the collection. Returns its unique _id. 


Arguments 


doc Object 


The document to insert. May not yet have an id attribute, in which case Meteor will 


generate one for you. 


callback Function 


Optional. If present, called with an error object as the first argument and, if no error, the id 


as the second. 


下 面 的 例子 展示 了 如 何 插入 文档 到 集合 里 : 


Posts.insert({ 
createdBy: Meteor.userId(), 
createdAt: new Date(), 
title: "My first post!", 
content: "Today was a good day." }); 


每 个 Mongo.Collection 里 的 每 个 文档 都 有 一 个 .id 字段 。 它 必须 是 唯一 的 ， 如 果 你 没有 提 
供 ， 会 自动 生成 。 collection.findone 使 用 id 可 以 用 来 检索 特定 的 文档 。 


collection.update(selector, modifier, [options], [callback]) 


Anywhere 


Modify one or more documents in the collection. Returns the number of affected documents. 


Arguments 

selector Mongo Selector, Object ID, or String 
Specifies which documents to modify 
modifier Mongo Modifier 

Specifies how to modify the documents 
callback Function 


Optional. If present, called with an error object as the first argument and, if no error, the 
number of affected documents as the second. 


Options 
multi Boolean 


True to modify all matching documents; false to only modify one of the matching documents 
(the default). 


upsert Boolean 
True to insert a document if no matching documents are found. 


这 里 的 选择 器 和 你 传 给 find 方法 的 是 一 致 的 ， 它 可 以 匹配 多 个 文档 。 修 改 器 是 一 个 对 象 ， 它 
89] 了 对 匹配 到 的 文档 要 做 的 修改 。 注 意 : 除非 你 使 用 了 $set 操作 符 ， 否 则 update 方法 会 
直接 用 修改 器 替换 整个 匹配 到 的 文档 。 


下 面 的 例子 展示 了 ， 设 置 所 有 标题 包含 "first" 的 文章 的 内 容 字段 


Posts.update(1( 
title: {$regex: /first/} 


$set: {content: "Tomorrow will be a great day."} 


}); 


关于 支持 的 所 有 operators 参 见 MongoDB documentation ° 
有 一 点 需要 注意 : 当 在 客户 端 调用 update 的 时 候 ， 只 能 通过 id 来 查找 文档 。 要 使 用 所 有 可 
用 的 选择 器 ， 必 须 在 服务 端 代 码 或 是 method 中 调用 update ° 


collection.remove(selector, [callback]) 


Anywhere 


Remove documents from the collection 


Arguments 

selector Mongo Selector, Object ID, or String 

Specifies which documents to remove 

callback Function 

Optional. If present, called with an error object as its argument. 


remove 方法 使 用 和 find ^ update 一 样 的 选择 器 ， 并 且 从 数据 库 中 移 除 所 有 匹配 到 的 文档 。 
请 小 心 使 用 remove 一 删 掉 的 数据 没 办 法 恢复 。 


和 update 一 样 ， 客 户 端 代 码 只 能 通过 ig 移 除 文档 ， 而 服务 端 代码 和 methods 可 以 使 用 任何 
选择 器 移 除 文档 。 


collection.allow(options) 


Server 

Allow users to write directly to this collection from client code, subject to limitations you 
define. 

Options 

insert, update, remove Function 


Functions that look at a proposed modification to the database and return true if it should be 
allowed. 


在 新 创建 的 APP 中 ，Meteor 人 允许 任何 客户 端 和 服务 端 代码 调用 insert , update ,和 remove 
这 是 因为 用 meteor create 创 nn & T insecure & > H caia 。 很 显 
然 ， 如 果 任 何 用 户 都 可 以 修改 数据 库 ， 这 是 很 不 安全 的 ， 所 以 移 除 insecure ， 并 声明 一 些 

权限 规则 是 很 重要 的 : 


$ meteor remove insecure 


一 旦 你 移 除 了 insecure 包 ， 就 可 以 用 allow 和 deny 来 控制 谁 可 以 执行 哪些 数据 库 操 作 。 默 
认 情 况 下 ， 客 户 端 所 有 的 操作 都 被 茶 止 ， 所 以 ， 需 要 添加 一 些 allow 规则 。 记 住 : 服务 端 代 
码 和 methods 不 受 allow 和 deny 影响 一 这 些 规 则 只 应 用 于 当 不 可 信 的 客户 端 代码 调 


用 insert , update , fe remove 时 。 


例如 ， 人 假设 只 有 当 createBy 字段 为 当前 用 户 ID 时 ， 才 人 允许 用 户 插 入 新 文章 ， 这 样 用 户 就 不 能 
冒充 其 他 人 


// In a file loaded on the server (ignored on the client) 
Posts.allow({ 
insert: function (userId, post) { 
// can only create posts where you are the author 
return post.createdBy === userId; 


remove: function (userId, post) ( 
// can only delete your own posts 
return post.createdBy === userId; 


} 


// since there is no update field, all updates 
// are automatically denied 


3); 

allow 方法 接受 三 个 回调 函数 : insert , remove , update ° — 4 EE ESCAS — AREE 
XH P) id ,其 余 的 参数 如 下 : 

1. insert(userId, document) 


document 是 将 要 插入 到 数据 库 的 文档 。 如 果 人 允许 插入 ， 则 返回 true > GUAE false 


2. update(userId, document, fieldNames, modifier) 


document 是 将 要 被 修改 的 文档 。 fieldNames 是 一 个 数组 ， 包 含 了 受 这 次 修改 影响 的 一 

级 字段 。 modifier 是 传 给 collection.update 的 第 二 个 参数 Mongo Modifier。 如 果 使 用 

这 个 回调 无 法 实现 正确 的 校 验 ， 那 么 推荐 使 用 methods。 如 果 允 许 修改 ， 则 返回 true ， 
否则 返回 false 


3. remove(userId, document) 


document 是 将 要 从 数据 库 中 移 除 的 文档 。 如 果 允 许 移 除 则 返回 true ° GAE false 


collection.deny(options) 


Server 


Override allow rules. 


Options 
insert, update, remove Function 


Functions that look at a proposed modification to the database and return true if it should be 
denied, even if an allow rule says otherwise. 


deny 方法 允许 你 选择 性 的 重 写 allow 规则 。 只 要 有 一 个 allow 回调 函数 返回 true ， 就 允许 
修改 ， 但 必须 所 有 deny 规则 都 返回 false， 才 允许 修改 。 


例如 ， 我 们 要 重 写 上 面 定义 的 allow 规则 : 排除 特定 标题 的 文章 : 


// In a file loaded on the server (ignored on the client) 
Posts.deny({ 
insert: function (userId, post) { 
// Don't allow posts with a certain title 
return post.title --- "First!"; 
} 
}); 


Accounts 


要 增加 账户 功能 ， 用 meteor add 添加 下 面 的 一 个 或 多 个 包 


e accounts-ui :这 个 包 允 许 你 通过 在 模板 中 使 用 ff&gt; loginButtons}} ， 来 添加 自动 生成 
的 登录 Ul， 用 户 可 以 登录 。 社 区 中 有 其 它 的 蔡 代 选择 ， 或 者 你 也 可 以 结合 使 用 advanced 
Accounts methods 

* accounts-password : l 个 包 人 允许 用 户 通 过 过 密码 登录 。 添 加 之 后 ， loginButtons 下 拉 框 会 
自动 增加 邮 和 有 re 

* accounts-facebook , accounts-google , accounts-github , accounts-twitter , 以 及 其 它 
由 社区 贡献 的 第 三 方 登录 包 ， 让 你 的 用 户 可 以 通过 第 三 方 网 站 登录 。 它们 会 自动 添加 登 
录 按 钮 到 loginButtons 下 拉 框 中 。 


{{> loginButtons)) Client 


JE HTML T 2] A. 1oginButtions 模板 ， 就 可 以 使 用 Meteor 默 认 的 登录 Ul。 使 用 前 ， 需 要 先 添 


加 accounts-ui 包 : 


$ meteor add accounts-ui 


Anywhere but publish functionsMeteor.user() 


Get the current user record, or null if no user is logged in. A reactive data source. 


从 Meteor.users 集合 中 获取 当前 登录 用 户 。 等 同 


于 Meteor.users. findOne(Meteor.userId()) ? 


Anywhere but publish functionsMeteor.userld() 


Get the current user id, or null if no user is logged in. A reactive data source. 


Meteor.users 


Anywhere 
A Mongo.Collection containing user documents. 


这 个 集合 包含 了 所 有 注册 用 户 ， 每 个 用 户 是 一 个 文档 。 例 如 : 


_id: "bbca5d6a-2156-41c4-89da-0329e8c99a4f",  // Meteor.userId() 
username: "cool kid 13", // unique name 
emails: [ 
// each email address can only belong to one user. 
( address: "coolQexample.com", verified: true j, 
( address: "anotherQdifferent.com", verified: false } 
l, 
createdAt: Wed Aug 21 2013 15:16:52 GMT-0700 (PDT), 
profile: { 
// The profile is writable by the user by default. 
name: "Joe Schmoe" 


} 
services: { 
facebook: { 
id: "709050", // facebook id 
accessToken: "AAACCgdX762.. .AbV9AZDZD" 
3 
resume: { 
loginTokens: 
( token: "97e8c205-c7e4-47c9-9bea-8e2ccc0694cd", 
when: 1349761684048 } 
] 
} 
} 


一 个 用 户 文档 可 以 包含 任何 你 想 保存 的 用 户 相 关 的 数据 。 不 过 ，Meteor 会 特殊 对 待 下 面 的 几 


个 字段 : 


e username : 一 个 唯一 的 字符 事 ， 可 以 标识 用 户 。 

* emails: 一 个 对 象 的 数组 。 对 象 包含 属性 address 和 verified 。 一 个 邮箱 地 址 只 能 属 
于 一 个 用 户 。 verified 是 一 个 布尔 值 ， 如 果 用 户 已 经 验证 邮箱 地 址 则 为 true。 

e createdAt : 用 户 文档 创建 时 间 。 

e profile : 一 个 对 象 ， 默 认 情 况 下 用 户 可 以 用 任何 数据 新 建 和 更 新 该 字段 。 

@ services : 包含 第 三 方 登 录 服 务 使 用 的 数据 的 对 象 。 例 如 ， 它 的 reset 字段 包含 的 
token， 用 于 忘记 密码 的 超 链 接 ， 它 的 resume 字段 包含 的 token， 用 于 维持 用 户 登 录 状 


Ao 


INN 


和 所 有 的 Mongo.Collection 一 样 ， 在 服务 端 ， 你 可 以 获取 用 户 集 合 的 所 有 文档 ， 但 是 在 客户 
能 获取 那些 服务 端 发 布 的 文档 。 


默认 情况 下 当前 用 户 的 username , emails ,和 profile 会 发 布 到 客户 3X» o 可 以 使 用 下 面 的 
代码 发 布 当前 用 户 的 其 它 字段 : 


// server 
Meteor.publish("userData", function () { 
if (this.userId) { 
return Meteor.users.find(( id: this.userId], 
(fields: ['other': 1, 'things': 1313); 
) else { 
this.ready(); 


} 
3) 


// client 
Meteor.subscribe("userData"); 


如 果 安 装 了 autopublish 包 ， 那 么 所 有 用 户 的 信息 都 会 发 布 到 所 有 客户 端 ? 包括 username , 
profile ,以 及 service 中 所 有 可 以 公开 的 字段 (例如 : services.facebook.id , 
services.twitter.screenName )。 另 外 ， 使 用 autopublish 时 ， 对 于 当前 登录 用 户 会 发 布 更 多 的 

信息 ， 包 括 access token。 这 样 就 可 以 直接 从 客户 端 发 起 API 调 用 。 


默认 情况 下 ， 用 户 可 以 通过 Accounts.createuser 声明 自己 的 profile 字段 ， 也 可 以 通 
过 Meteor.users.update 来 修改 它 。 要 允许 用 户 修改 更 多 的 字段 ， 使 用 Meteor.users.allow ， 
要 禁止 用 户 对 自己 的 文档 做 任何 修改 ， 使 用 : 


Meteor.users.deny([update: function () { return true; }}); 


(4 currentUser }} 


Calls Meteor.user(). Use {{#if currentUser}} to check whether the user is logged in. 


Methods 


Methods 是 可 以 从 客户 端 调 用 的 服务 端 函 数 。 当 你 想 做 一 些 比 insert, update 或 是 
remove 复杂 的 事情 ， 或 是 进行 数据 验证 ， 而 allow 和 deny 又 无 法 满足 需求 时 ， 使 用 
Methods 非 常 合适 。 


Methods 可 以 返回 值 或 是 抛 出 错误 。 


Meteor.methods(methods) 


Anywhere 


Defines functions that can be invoked over the network by clients. 


Arguments 
methods Object 
Dictionary whose keys are method names and values are functions. 


在 服务 端 调用 Meteor.methods 定义 的 函数 可 以 在 客户 端 远 程 调用 。 下 面 是 一 个 method 的 例 
子 ， 检 查 参 数 ， 抛 出 错误 : 


// On the server 
Meteor .methods({ 
commentOnPost: function (comment, postId) { 
// Check argument types 
check(comment, String); 
check(postId, String); 


if (! this.userId) { 


throw new Meteor.Error("not-logged-in", 
"Must be logged in to post a comment."); 
} 


// ... do stuff ... 


return "something"; 


F 


otherMethod: function () { 
7/7/20 X OO ONE SENE mon 


J 
3); 


check 函数 用 于 确保 method 的 参数 是 期 望 的 类 型 和 结构 。 


在 method 定 义 中 ， this 绑 定 到 一 个 method 调 用 对 象 ，method 调 用 对 象 有 几 个 非常 有 用 的 属 
性 ， 包 括 : 用 于 标识 当前 登录 用 户 的 this.userId ° 


你 不 用 把 所 有 的 method 定 义 都 放 到 一 个 Meteor ,methods 里 面 ; 可 以 多 次 调 
用 Meteor.methods ， 只 要 每 个 method 的 名 字 是 唯一 的 。 


Latency Compensation 


调用 服务 端的 一 个 method 会 产生 在 网 络 上 一 个 来 回 的 延迟 。 如 果 用 户 由 于 这 个 延迟 ， 需 要 等 
待 一 秒 才能 看 到 自己 的 评论 显示 出 来 ， 会 让 人 非常 不 严 。 这 就 是 为 什么 Meteor 有 一 个 叫做 
method stubs 的 功能 。 如 果 你 在 客户 端 定 义 了 一 个 和 服务 端 同 名 的 method，Meteor 会 运行 
它 ， 尝 试 预测 服务 端 运 行 的 结果 。 当 服务 端 代 码 执行 完毕 后 ， 客 户 端 生成 的 预测 结果 会 被 实 
际 结果 替代 。 

insert , update , fe remove 的 客户 端 版 本 Y 都 是 以 method 方 式 实现 这 样 在 客户 端 与 数据 


库 进 行 交 互 的 结果 就 会 立即 呈现 。 


Meteor.call(name, [arg1, arg2...], [asyncCallback]) 


Anywhere 


Invokes a method passing any number of arguments. 


Arguments 

name String 

Name of method to invoke 

arg1, arg2... EJSON-able Object 
Optional method arguments 
asyncCallback Function 


Optional callback, which is called asynchronously with the error or result after the method is 
complete. If not provided, the method runs synchronously if possible (see below). 


用 上 面 的 方法 来 调用 method 。 


On the client 


在 客户 端 调用 的 Method 是 异步 执行 ， 为 了 能 够 获取 执行 结果 ， 你 需要 传 入 一 个 回调 函数 。 回 
调 函 数 会 收 到 两 个 参数 error 和 result 。 除 非 有 异常 抛 出 ， 否 则 error 参数 为 null ° X 
有 异常 抛 出 时 ， error 参数 是 Meteor.Error 的 一 个 实例 ， 同 时 result 参数 是 undefined 。 


示例 : 调用 commentonPost method ， 传 入 两 个 参数 comment 和 postid : 


// Asynchronous call with a callback on the client 
Meteor.call('commentOnPost', comment, postId, function (error, result) { 
if (error) { 
// handle error 
L else ( 
// examine result 


J 
3); 
作为 方法 调用 的 一 部 分 ，Meteor 会 跟踪 数据 库 的 更 新 ， 直 到 所 有 的 更 新 都 发 送 到 客户 端 之 后 
才 调 用 客户 端 回调 函数 。 


On the server 


在 服务 端 ， 不 用 传 入 回调 函数 一 方法 调用 会 阻塞 直到 执行 完毕 ， 返 回 结果 或 是 抛 出 异常 ， 就 
好 像 直接 调用 有 函数 一 样 : 


// Synchronous call on the server with no callback 
var result - Meteor.call('commentOnPost', comment, postId); 


new Meteor.Error(error, [reason], [details]) 


Anywhere 


This class represents a symbolic error thrown by a method. 


Arguments 
error String 


A string code uniquely identifying this kind of error. This string should be used by callers of 
the method to determine the appropriate action to take, instead of attempting to parse the 
reason or details fields. For example: 


// on the server, pick a code unique to this error 
// the reason field should be a useful debug message 
throw new Meteor.Error("logged-out", 

"The user must be logged in to post a comment."); 


// on the client 
Meteor.call("methodName", function (error) { 
// identify the error 
if (error.error === "logged-out") ( 
// show a nice error message 
Session.set("errorMessage", "Please log in to post a comment."); 
} 
}); 


For legacy reasons, some built-in Meteor functions such as check throw errors with a 
number in this field. 


reason String 
Optional. A short human-readable summary of the error, like 'Not Found". 
details String 


Optional. Additional information about the error, like a textual stack trace. 


想 在 method 中 返回 一 个 错误 ， 使 用 抛 出 异常 。Method 可 以 抛 出 任意 类 型 的 异常 ， 但 是 只 
Meteor.Error 类 型 的 错误 会 发 送 到 客户 端 。 如 果 method 抛 出 一 个 其 它 类 型 的 异常 ， 客 户 端 


会 收 到 Meteor.Error(500, 'Internal server error') ? 


发 布 和 订阅 


Meteor 服务 端 可 以 通过 Meteor.publish 发 布 文档 集 ， 同 时 客户 ids 
过 Meteor.subscribe 订阅 这 些 发 布 。 任 何 客户 端 订 阅 的 文档 都 可 以 通过 find 方法 进行 查询 
使 用 。 


默认 情况 下 ， 每 个 新 创建 的 Meteor 应 用 包含 有 autopublish 包 ， 它 会 自动 为 每 个 客户 端 发 布 
所 有 可 用 的 文档 。 为 了 可 以 更 细 化 的 控制 不 同 客户 端 所 接收 的 数据 文档 ,首先 应 该 在 终端 移 除 
autopublish : 


$ meteor remove autopublish 


现在 ， 你 可 以 使 用 Mweteor.publish 和 Meteor.subscribe 来 控制 不 同 的 文档 从 服务 端 推送 到 
不 同 的 客户 端 了 


Meteorpublish(name, func) 


Server 


Publish a record set. 


Arguments 
name String 


Name of the record set. If null , the set has no name, and the record set is automatically 
sent to all connected clients. 


func Function 


Function called on the server each time a client subscribes. Inside the function, tnis is the 
publish handler object, described below. If the client passed arguments to subscribe , the 
function is called with the same arguments. 


将 数据 发 布 到 客户 端 ， 通 过 在 服务 端 调 用 Meteor.publish， 需 要 传 入 两 个 参数 : 该 记录 集 的 名 
称 ， 以 及 一 个 会 在 每 一 次 客户 端 订 阅 该 记录 集 的 时 候 被 调用 的 发 布 功 能 函数 。 


发 布 功 能 通过 返回 在 一 些 collection 调用 collection. find(query) 的 结果 。 通 过 query 来 限 
制 发 布 的 文档 集 : 


// 发 布 已 登录 用 户 的 文章 集合 
Meteor.publish("posts", function () { 

return Posts.find(( createdBy: this.userId }); 
15 


你 可 以 发 布 来 自 多 个 collection 的 文档 ， 通 过 返回 一 个 collection.find 结果 集合 : 


// 发 布 一 个 单独 的 文章 和 对 应 的 评论 
Meteor.publish("postAndComments", function (postId) { 
// 检查 参数 
check(postId, String); 


return [ 
Posts.find(( id: postId jJ), 
Comments.find([ postId: roomId }) 


J; 
}); 


在 发 布 功 能 里 ， this.userId 是 当前 登录 用 户 的 _id ,在 某 些 文档 仅 对 特定 用 户 可 见 时 ， 可 以 
用 其 来 过 滤 集 合 。 如 果 客 户 端 登录 的 用 户 发 生 改 变 ， 发 布 功能 也 将 自动 使 用 新 的 userid ,所 
以 新 用 户 无 法 访问 任何 只 限于 之 前 登录 用 户 的 文档 。 


Meteorsubscribe(name, [arg1, arg2...], [callbacks]) 


Client 


Subscribe to a record set. Returns a handle that provides stop() and ready() methods. 


Arguments 

name String 

Name of the subscription. Matches the name of the server's publish() call. 
arg1, arg2... Any 

Optional arguments passed to publisher function on server. 

callbacks Function or Object 


Optional. May include onstop and onReady callbacks. If there is an error, it is passed as an 
argument to  onstop . If a function is passed instead of an object, it is interpreted as an 
onReady callback. 


客户 端 调用 Meteor.subscribe 来 订阅 服务 端 发 布 的 文档 集合 。 客户 端 可 以 进一步 过 滤 文档 集 
合 通过 调用 collection.find(query) . 当 任 何 通过 发 布 功能 发 布 的 可 访问 的 数据 在 服务 端 发 生 
改变 时 ， 发 布 功能 会 自动 返回 和 更 新 发 布 的 文档 集合 推送 给 客户 端 。 


onReady 回调 函数 在 服务 端 已 经 发 送 了 订阅 的 所 有 初始 化 数据 时 被 调用 ， 无 需 传 入 任何 参 
数 。 onstop 订阅 不 管 以 任何 原因 被 终止 时 调用 ;如 果 订 阅 失败 是 由 于 服务 端 错误 ， 它 将 收 到 


-—"rtMeteor.Error ° 
Meteor.subscribe 返回 一 个 订阅 名 柄 ， 是 一 个 包含 以 下 方法 的 对 象 : 


stop() 


取消 订阅 。 这 通常 会 导致 服务 器 引导 客户 端 从 客户 端 缓存 中 删除 订阅 的 数据 。 
ready() 
如 果 服 务 端 已 经 设置 状态 为 ready， 将 会 返回 True。 一 个 反应 式 数 据 源 。 


如 果 你 在 Tracker.autorun 里 调用 Meteor.subscribe , 当 运 算 返 回 时 ， 订 阅 将 被 自动 取消 (所 以 
如 果 人 合适 的 话 ， 一 个 新 的 订阅 会 被 创建 )， 意味 着 你 不 能 够 在 来 自 Tracker.autorun 里 的 订阅 中 
调用 stop ? 


Environment 


Meteor.isClient 


Anywhere 


Boolean variable. True if running in client environment. 


Meteor.isServer 


Anywhere 
Boolean variable. True if running in server environment. 


Meteor.isserver 可 以 用 来 限制 代码 的 运行 位 置 ， 但 是 它 不 会 阻止 代码 发 送 到 客户 端 。 任 何 你 
包含 密码 


不 想 发 送 到 客户 端的 敏感 代码 ， 例 如 密码 或 是 认证 机 制 的 代码 ， 都 应 该 放 到 server 文件 
x o 

Meteor.startup(func) 

Anywhere 


Run code when a client or a server starts. 


Arguments 
func Function 
A function to run on startup. 


在 服务 端 只 要 服务 进程 启动 完成 ， 回 调 函 数 就 会 执行 。 在 客户 端 ， 只 要 页 面 ready， 回 调 函 
数 就 会 执行 。 


最 佳 实践 是 : 把 模板 事件 ， 模板 Helper ， Meteor.methods , Meteor.publish , 或 是 
Meteor.subscribe Ž |&44X48 & € 3t Meteor.startup ， 这 样 APP 的 代码 就 不 会 在 环境 准备 好 
之 前 运行 。 


例如 : 当 服 务 端 启动 时 ， 如 果 数 据 库 为 空 则 创建 一 些 初 始 数 据 ， 可 以 用 下 面 的 方式 : 


if (Meteor.isServer) { 
Meteor.startup(function () { 
if (Rooms.find().count() === 0) { 
Rooms.insert(([name: "Initial room"); 
} 
}); 
} 


如 果 在 服务 端 进程 启动 完成 之 后 ， 或 是 客户 端 ， 页 面 ready 之 后 调用 Meteor.startup ° H% $ 
数 会 立即 执 


o 


— 
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Packages 


Meteor 所 有 的 功能 都 是 以 模块 化 的 包 实 现 的 。 除 了 上 面 提 到 的 核心 包 之 外 ， 还 有 很 多 可 以 用 
来 增加 功能 的 包 。 


在 命令 行 ? TS Ja Fe TR] 除 包 使 用 meteor add 和 meteor remove : 


# add the less package 
meteor add less 


# remove the less package 
meteor remove less 


当 添 加 或 是 删除 包 的 时 候 ，APP 会 自动 重启 。APP 的 包 依 赖 通 过 .meteor/packages 记录 跟 
踪 ， 当 你 的 同事 更 新 项 目 源 代码 后 ， 会 自动 更 新 为 相同 的 包 ， 因 为 你 们 
的 .meteor/packages 文件 是 相同 的 。 


在 APP 目 录 下 ， 运 行 meteor list 可 以 查看 APP 使 用 了 哪些 包 。 


Searching for packages 


目前 查找 包 最 好 的 方式 就 是 通过 官方 的 Meteor 包 服务 器 Atmosphere。 也 可 以 直接 通过 命 

令 meteor Search 搜索 包 R 

包 名 中 间 带 : 的 ， 例 如 : mquandalle:jade ， 说 明 是 由 社区 成 员 编写 和 维护 的 。 冒 号 前 边 是 
创建 这 个 包 的 成 员 或 组 织 名 称 。 不 带 冒 号 的 ， 说 明 是 由 Meteor Development Group 维护 ， 作 
为 Meteor 框 架 的 一 部 分 。 


当前 在 Atmosphere 上 有 起 过 两 千 个 包 。 下 面 列 出 了 一 些 非 常 有 用 的 包 。 


accounts-ui 


Meteor 账户 系统 的 播 入 式 Ul。 添 加 这 个 包 之 后 ， 用 ([&gt; loginButtons)) 插入 到 模板 中 。UI 
自动 匹配 任何 已 添加 的 登录 服务 ， 例 如 accounts-password , accounts-facebook 等 等 。 


See the docs about accounts-ui above.. 


coffeescript 


在 APP 中 使 用 CoffeeScript。 添 加 了 这 个 包 之 后 ， 所 有 以 coffee 后 级 结尾 的 文件 都 会 由 
Meteor 的 构建 系统 编译 为 javascript ^ 


email 


发 送 邮 件 。 参 见 email section of the full API docs 


mquandalle:jade 


在 APP 中 使 用 Jade 作 为 模板 语言 。 添 加 包 之 后 ， 任 何以 jade 作为 后 组 的 文件 都 会 编译 为 
Meteor 模 板 。 详 情 参 见 page on Atmosphere 


jquery 
JQuery 让 跨 浏 览 器 进行 HTML 人 遍历， 操作 ， 事 件 处 理 ， 和 动画 操作 变 得 简单 。 


JQuery 自 动 添加 到 每 个 Meteor APP 中 ， 因 为 框架 大 量 的 使 用 了 jQuery。 详 情 参见 JQuery 
docs ° 


http 


利用 这 个 包 可 以 在 客户 端 和 服务 端 使 用 相同 的 API 发 送 HTTP 请 求 。 使 用 方法 参见 http docs。 


less 


添加 LESS CSS 预 处 理 器 到 APP ， less 后 级 的 文件 都 会 编译 为 常规 CSS。 如 果 想 使 
用 @import 引入 其 他 文件 ， 同 时 又 不 想 让 Meteor 自 动 编译 它们 ， 使 用 .import,less 后 级 。 


markdown 


在 模板 中 插入 Markdown 人 代码。 使 用 {{# markdown)) Helper 很 简单 : 


«div class="my-div"> 
{{#markdown}} 
# My heading 


Some paragraph text 


{{/markdown}} 
</div> 


确保 你 的 markdown 缩 进 正 确 。 


underscore 


Underscore 提供 了 一 系列 有 用 的 函数 ， 用 来 操作 数组 ， 对 象 ， 和 函数 。 每 个 Meteor APP 都 包 
4 underscore &, 2 因为 框架 大 量 使 用 了 underscore ° 


spiderable 


3k Ae E, "T VATEAPP EUR 435 3E 4118 AE ^ AHR RI SEE RIRA DAR o de XE XSEOS 
话 ， 那 么 应 该 添加 这 个 包 。 


查看 


` 


完整 API 文档 


' 你 已 经 看 完了 Meteor 基 础 文档 。 更 多 高 
多 高 级 的 功能 和 详细 的 介绍 ， 请 看 完整 
绍 ， 请 看 完整 版 API X 


